home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 2.iso / dist / fw_knews.idb / usr / freeware / catman / u_man / cat1 / knews.Z / knews
Text File  |  1999-10-18  |  73KB  |  1,585 lines
  1.  
  2.  
  3.  
  4.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       knews    - Karl's threaded newsreader for X
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       kkkknnnneeeewwwwssss    [ options ]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.       Knews    is a threaded newsreader with an X Window interface
  16.       that uses NNTP to get    news. This manual is intended to
  17.       explain things that are not apparent from the    interface, so
  18.       if you just want to get started, you probably    don't need to
  19.       read this.
  20.  
  21.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  22.       In addition to the standard X    Toolkit    options    knews accepts
  23.       the following    options, which set various X resources.     For
  24.       an explanation of what the resources do, see the sections on
  25.       resources and    the config file.
  26.  
  27.       You don't have to type out the entire    name of    the option, as
  28.       long as it is    unique.
  29.  
  30.       ----nnnnnnnnttttppppSSSSeeeerrrrvvvveeeerrrr hhhhoooossssttttnnnnaaaammmmeeee
  31.            Sets the    resource 'Knews.nntpServer' to 'hostname'.
  32.            This will cause knews to    connect    to this    server on
  33.            startup.
  34.  
  35.       ++++////----bbbbeeeellllllll
  36.            Sets the    resource 'Knews.bell' to True/False.
  37.  
  38.       ++++////----sssseeeeppppaaaarrrraaaatttteeee
  39.            Sets the    resource 'Knews.separateWindows' to
  40.            True/False.
  41.  
  42.       ++++////----aaaaccccttttiiiivvvveeee
  43.            Sets the    resource 'Knews.readActiveFile'    to True/False.
  44.  
  45.       ++++////----ddddeeeessssccccrrrriiiippppttttiiiioooonnnnssss
  46.            Sets the    resource 'Knews.retrieveDescriptions' to
  47.            True/False.
  48.  
  49.       ++++////----ffffiiiillllllll
  50.            Sets the    resource 'Knews.fillNewsrcFile'    to True/False.
  51.  
  52.       ++++////----kkkkeeeeeeeepppp
  53.            Sets the    resource 'Knews.keepThreadInfo'    to True/False.
  54.  
  55.       ----iiiinnnnssssttttaaaallllllll
  56.            This will make knews install its    own colormap.
  57.  
  58.       ----vvvviiiissssuuuuaaaallll ccccllllaaaassssssss
  59.       ----ddddeeeepppptttthhhh bbbbiiiittttssss
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 8/26/99)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  71.  
  72.  
  73.  
  74.            These will set the resources 'Knews.visualClass'    and
  75.            'Knews.visualDepth'.
  76.  
  77.       ++++////----iiiiccccaaaasssseeee
  78.            Will set    the resource 'Knews.icaseRegexps' to
  79.            True/False.
  80.  
  81.       ++++////----iiiimmmmaaaaggggeeeessss
  82.            This will turn on/off inline images and color
  83.            allocation.
  84.  
  85.       ----nnnnccccoooollllssss nnnnuuuummmmbbbbeeeerrrr
  86.            Sets the    resource Knews.nCols to    'number', which    is the
  87.            max number of colors knews will allocate    for inline
  88.            images.
  89.  
  90.       ----vvvveeeerrrrssssiiiioooonnnn
  91.            Prints out the version and compile time to stderr and
  92.            quits.
  93.  
  94.  
  95.      TTTTHHHHEEEE TTTTHHHHRRRREEEEAAAADDDD    TTTTRRRREEEEEEEE
  96.       The articles in a thread are displayed as nodes in a tree. A
  97.       border inside    a node indicates that the article is unread, a
  98.       border outside a node    indicates that the article is
  99.       'tagged', and    a dashed branch    in the tree indicates a    change
  100.       of subject. By default, you can scroll around    in the tree
  101.       with the middle mouse    button.    An empty box in    the tree
  102.       indicates a 'fake' article, i.e. one that has    expired    on the
  103.       server, has not yet arrived or was posted in a different
  104.       newsgroup.
  105.  
  106.  
  107.      TTTTAAAAGGGGGGGGIIIINNNNGGGG AAAARRRRTTTTIIIICCCCLLLLEEEESSSS
  108.       Articles in the thread tree can be tagged with the third
  109.       mouse    button.     Clicking on a subject with the    third mouse
  110.       button causes    the unread articles in that thread to be
  111.       tagged in preorder (depth first). Once you have tagged the
  112.       articles, you    can mark then read/unread, save    or pipe    them
  113.       in order, and    so on.
  114.  
  115.  
  116.      CCCCLLLLIIIICCCCKKKKIIIINNNNGGGG OOOONNNN UUUURRRRLLLLSSSS
  117.       Knews    supports a simple form of clicking on URLs.  It    works
  118.       by selecting a piece of text in the article text window and
  119.       clicking on it with the middle mouse button.    If there is no
  120.       selection, knews will    make a crude guess as to what the URL
  121.       might    be.  The resource Knews.urlCommand must    be set for
  122.       this to work,    see the    section    on X resources for details.
  123.  
  124.  
  125.      DDDDRRRRAAAAGGGG AAAANNNNDDDD DDDDRRRROOOOPPPP
  126.  
  127.  
  128.  
  129.      PPPPaaaaggggeeee 2222                         ((((pppprrrriiiinnnntttteeeedddd 8888////22226666////99999999))))
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  137.  
  138.  
  139.  
  140.       The all groups list and the kill list    can be reordered by
  141.       drag'n'drop.    The default translation    is the second mouse
  142.       button.
  143.  
  144.  
  145.      AAAABBBBOOOORRRRTTTT
  146.       You may abort    the interaction    with the NNTP server at    any
  147.       time.    This causes the    connection to be closed, and a new one
  148.       to be    opened.    Note that this puts a certain load on the
  149.       server.
  150.  
  151.  
  152.      TTTTHHHHRRRREEEEAAAADDDD AAAAHHHHEEEEAAAADDDD
  153.       Knews    is capable of threading    groups in the background while
  154.       you are e.g. reading another group.  To do this you click on
  155.       one or more groups in    the group list with the    right mouse
  156.       button.  Knews then opens a second connection    to the server
  157.       and uses it to thread    the selected groups.  The status of
  158.       the thread ahead is shown in the group list as a character:
  159.  
  160.       -      The group is scheduled for thread ahead.
  161.       *      The group is being threaded.
  162.       +      The group has    been threaded.
  163.  
  164.  
  165.      RRRREEEEGGGGUUUULLLLAAAARRRR EEEEXXXXPPPPRRRREEEESSSSSSSSIIIIOOOONNNNSSSS
  166.       The regular expressions used by knews    are POSIX.2 extended
  167.       regular expressions, similar to those    used by    egrep(1), by
  168.       default case insensitive.  Note that these are not anchored
  169.       by default, so that e.g. the expression 'alt'    will match any
  170.       string containing the    three character    sequence 'alt'.     See
  171.       Henry    Spencer's excellent man-page for details, regex(7).
  172.  
  173.  
  174.      SSSSEEEEAAAARRRRCCCCHHHHIIIINNNNGGGG
  175.       Article heads    and bodies may be searched for regular
  176.       expressions.    Searching applies to read or unread articles
  177.       as specified with the    'only unread' toggle, and starts with
  178.       the 'next' article.  The newsgroup list may also be
  179.       searched.
  180.  
  181.       Note:    the 'Stop' button stops    the search as soon as the
  182.       current article has been retrieved from the server.  This is
  183.       different from 'Abort' which requires    closing    and reopening
  184.       the connection to the    server.
  185.  
  186.       It is    also possible to use XPAT searching, if    the nntp
  187.       server supports it.  To do this, you fill in the 'Header'
  188.       field    on the search popup with the header you're interested
  189.       in (e.g. 'Content-Type') and the wildcard field with a
  190.       wildcard expression.    Pressing 'Submit' then sends this to
  191.       the server, and after    a while    it responds with a list    of
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 8/26/99)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  203.  
  204.  
  205.  
  206.       matching articles.  You can then move    between    those articles
  207.       with the 'Next' and 'First' buttons on the search popup.
  208.  
  209.  
  210.      FFFFIIIILLLLEEEE NNNNAAAAMMMMEEEE EEEEXXXXPPPPAAAANNNNSSSSIIIIOOOONNNN
  211.       In most places where knews uses file names, such as the
  212.       save/pipe popup, the save/pipe action    procedures, and    the
  213.       newsrcFile options etc, ~ is expanded    to $HOME, and the
  214.       following %'s    are expanded:
  215.  
  216.       %%      %
  217.       %n      The name of the current group.
  218.       %N      The name of the current group, capitalized.
  219.       %g      The name of the current group, slashed.
  220.       %G      The name of the current group, capitalized and slashed.
  221.       %s      The name of the nntp server.
  222.       %p      The number of    the port the server listens to.
  223.       %a      The number of    the currently selected article.
  224.  
  225.       Slashed means    that the dots are replaced with    slashes.  Note
  226.       that if you save an entire thread to a file continaing %a,
  227.       the number will not change with the article.
  228.  
  229.  
  230.      TTTTHHHHEEEE KKKKIIIILLLLLLLL FFFFIIIILLLLEEEE
  231.       The kill file    may be used to 'kill' (mark read) or 'hot'
  232.       (mark    interesting) articles, subjects    and threads based on
  233.       different criteria.
  234.  
  235.       Each line in the kill    file specifies an entry    according to
  236.       the following    syntax:
  237.  
  238.       (F)(S)(A)[Col] || Group regexp || Field expression
  239.  
  240.       ((((FFFF))))
  241.            This is a character specifying to which header this
  242.            entry applies.  Legal values are:
  243.  
  244.            'M'     The 'Message-ID:' header, by far    the most efficient.
  245.            'S'     The 'Subject:' header.
  246.            'F'     The 'From:' header.
  247.            'X'     The 'Xref:' header.
  248.  
  249.            Note that 'X' only works    if the 'Xref:' header is
  250.            included    in the overview    files from the server. Also
  251.            note that the 'Re: ' prefix is not considered part of
  252.            the subject.
  253.  
  254.            Entries applying    to a message-id    automatically expire
  255.            when the    relevant article has expired.
  256.  
  257.       ((((SSSS))))
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 8/26/99)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  269.  
  270.  
  271.  
  272.            This is a character specifying the scope    of the entry,
  273.            i.e. what articles are killed/'hotted' when this    entry
  274.            applies to an article. Legal values are:
  275.  
  276.            'A'     This article.
  277.            'S'     All articles with the same subject.
  278.            'T'     The entire thread.
  279.            't'     The subthread starting with this    article.
  280.  
  281.       ((((AAAA))))
  282.            This is a character specifying the action of the    entry.
  283.            Legal values are:
  284.  
  285.            'K'     Kill, which means mark read.
  286.            'H'     Hot, which means    mark interesting.
  287.  
  288.       [[[[ccccoooollll]]]]
  289.            In 'hot'    entries, this is the color used    to mark    the
  290.            relevant    articles with.
  291.  
  292.       ||||||||
  293.            This two    character sequence is used as a    separator.
  294.  
  295.       GGGGrrrroooouuuupppp    rrrreeeeggggeeeexxxxpppp
  296.            Only newsgroups matching    this regular expression    will
  297.            be affected by this entry.  This    field is empty in the
  298.            per-group kill files.
  299.  
  300.       FFFFiiiieeeelllldddd    eeeexxxxpppprrrreeeessssssssiiiioooonnnn
  301.            If the header field is 'S', 'F' or 'X', this is a
  302.            regular expression, and the entry applies to all
  303.            matching    articles. If the header    field is 'M', this is
  304.            a message id; this id is    probably the fastest type of
  305.            kill entry, since it can    be checked with    a single hash
  306.            lookup.
  307.  
  308.       To see what articles were killed: when you have read all
  309.       unread articles, or marked them read,    use the    'mark unread,
  310.       killed' feature on the misc menu.
  311.  
  312.       When a kill rule is applied, hot articles are    not killed.
  313.       Since    the entries in the kill    file are processed in order,
  314.       it is    possible to put    kills at the beginning,    so that    the
  315.       articles are killed before they have a chance    to become hot.
  316.  
  317.       There    is one global kill file    (~/.knews/.kill-%s by default)
  318.       and one kill file per    group (~/.knews/%s/%g/KILL by
  319.       default).  The rules in the global kill file are applied
  320.       before the per-group kill file.
  321.  
  322.  
  323.      MMMMIIIIMMMMEEEE VVVVIIIIEEEEWWWWEEEERRRRSSSS AAAANNNNDDDD MMMMAAAAIIIILLLLCCCCAAAAPPPP FFFFIIIILLLLEEEESSSS
  324.  
  325.  
  326.  
  327.      PPPPaaaaggggeeee 5555                         ((((pppprrrriiiinnnntttteeeedddd 8888////22226666////99999999))))
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  335.  
  336.  
  337.  
  338.       Knews    has internal support for content-types text/plain,
  339.       message/rfc822, message/partial, multipart/mixed and
  340.       multipart/digest.  For other types, knews will look for a
  341.       mailcap entry    for that type (see mailcap(5)).     If one    is
  342.       found, a clickable line will be inserted in the article text
  343.       window that is used to start the viewer.  If there is    no
  344.       viewer, then if the type is a    subtype    of text, knews will
  345.       display it, if it is a subtype of multipart, knews will
  346.       treat    it as multipart/mixed, and otherwise knews will    give
  347.       the user opportunity to 'Save    or Pipe'.
  348.  
  349.       Mailcap files    are found via the environment variable
  350.       MAILCAPS, which is a colon separated list of path names.  If
  351.       this variable    is not set, a default list of
  352.  
  353.       $HOME/.mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap
  354.  
  355.       will be used.     Note that all files found will    be merged to
  356.       produce the mailcap database.
  357.  
  358.       As a hack around miss/over designed mailcap files, knews
  359.       will ignore entries for text/plain and multipart/mixed.
  360.  
  361.  
  362.      TTTTEEEEXXXXTTTT////PPPPLLLLAAAAIIIINNNN    AAAARRRRTTTTIIIICCCCLLLLEEEESSSS
  363.       The following    resources determine how    knews will display an
  364.       article of type text/plain with a particular charset:
  365.  
  366.       Knews.charset.headerFont
  367.       Knews.charset.bodyFont
  368.       Knews.charset.quoteFont
  369.       Knews.charset.listFont
  370.       Knews.charset.treeFont
  371.       Knews.charset.encoding
  372.       Knews.charset.headEncHack
  373.  
  374.       The header, body and quote fonts are used for    displaying
  375.       headers, ordinary text and quoted text in the    article
  376.       window.  Knews also has some support for encoded 16-bit
  377.       charsets, this is specified with the encoding    resource.
  378.       Legal    values for this    are:
  379.  
  380.       utf-7          The encoding specified for unicode in rfc    1642.
  381.       16-bit      Straight 16-bit network byte order.
  382.       hz-gb-2312  The encoding for chinese described in rfc    1842.
  383.       ksc-5601    Also called iso-2022-kr, described in rfc    1557.
  384.       big5          Another encoding for chinese.
  385.  
  386.       Note that due    to the authors non-existent understanding of
  387.       asian    languages these    encodings have not been    extensively
  388.       tested.  Lots    of guess work here.
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                         (printed 8/26/99)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  401.  
  402.  
  403.  
  404.       For every newsgroup it is possible to    specify    a default
  405.       charset (see the section on THE CONFIG FILE).     The fonts for
  406.       this charset will be used to display articles    without    proper
  407.       MIME-headers.     Also, the listFont and    treeFont (which    may
  408.       not be encoded) will be used in the thread list and article
  409.       tree,    respectively.
  410.  
  411.       When specifying an encoded charset as    defaultCharset,    it may
  412.       be desirable to still    assume that headers are    ascii.    This
  413.       may be accomplished by setting the 'headEncHack' resource
  414.       listed above,    and setting the    headerFont to an ascii
  415.       (superset) font.
  416.  
  417.  
  418.      MMMMEEEESSSSSSSSAAAAGGGGEEEE////PPPPAAAARRRRTTTTIIIIAAAALLLL
  419.       Unless the config option assemblePartials is False (see the
  420.       section on THE CONFIG    FILE), when knews encounters an
  421.       article of type message/partial, it will be rememberered.
  422.       When all the parts have been seen, a notice will be popped
  423.       up offering to assemble the parts.
  424.  
  425.       There    is also    an entry on the    misc menu that allows a    number
  426.       of articles to be tagged and processed to look for
  427.       message/partial articles.
  428.  
  429.  
  430.      PPPPOOOOSSSSTTTTIIIINNNNGGGG MMMMIIIIMMMMEEEE
  431.       When you post    an article containing 8    bit characters that
  432.       doesn't have a Content-Type header, knews will add such a
  433.       header with charset equal to the value of the    defaultCharset
  434.       config option.  Also,    when quoting articles with Content-
  435.       Type:    text/plain and charset equal to    the defaultCharset,
  436.       knews    will decode the    article    before quoting.     In both these
  437.       contexts, the    charset    iso-8859-1 will    be used    if
  438.       defaultCharset is not    set.
  439.  
  440.  
  441.      RRRREEEEAAAADDDDIIIINNNNGGGG TTTTHHHHEEEE SSSSPPPPOOOOOOOOLLLLDDDDIIIIRRRR
  442.       Knews    supports a rather obscure mechanism for    communicating
  443.       with an arbitrary program instead of an nntp server.    Using
  444.       knewsd(1), this can be used for reading news (in)directly
  445.       from the spool dir, or even mail folders if they are in the
  446.       correct format.  This    is how it works:  If the nntp server
  447.       is given as #str, where str is an arbitrary string not
  448.       containing white space or the    characters '/',    '.' or '*',
  449.       knews    finds the value    of the resource    KKKKnnnneeeewwwwssss....####ssssttttrrrr and tries
  450.       to execute that program.  The    program    has its    standard input
  451.       and output connected to knews.  If you use this resource
  452.       setting:
  453.  
  454.       Knews.#spool:    knewsd -spool /var/spool/news \
  455.           -active /usr/local/news/active
  456.  
  457.  
  458.  
  459.      Page 7                         (printed 8/26/99)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  467.  
  468.  
  469.  
  470.       with the appropriate paths for your system, you can read the
  471.       spool    directory by specifying    the nntp server    as '#spool' in
  472.       e.g. the connect dialogue.  This could easily    be used    to
  473.       read mh(1) style mail    folders    too.
  474.  
  475.  
  476.      XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
  477.       There    are a number of    X resources that affect    the behaviour
  478.       and appearance of knews.   Most widgets in the widget
  479.       hierarchy has    resources named    bbbbaaaacccckkkkggggrrrroooouuuunnnndddd , ffffoooorrrreeeeggggrrrroooouuuunnnndddd    ,
  480.       sssshhhhaaaaddddoooowwwwWWWWiiiiddddtttthhhh ,    and so on. For more information    see the
  481.       application defaults file Knews.ad included in the
  482.       distribution.    To get a feeling for resources,    try
  483.       editres(1).
  484.  
  485.       Knews    contains a small xpm-file to pixmap converter, so it
  486.       is possible to use settings like e.g.
  487.  
  488.       Knews*backgroundPixmap:  ~/pixmaps/texture.xpm
  489.  
  490.       KKKKnnnneeeewwwwssss....nnnnnnnnttttppppSSSSeeeerrrrvvvveeeerrrr
  491.            If this resource    is set,    knews automatically connects
  492.            to this nntp server on startup. This overrides the
  493.            NNTPSERVER environment variable.    If the server listens
  494.            to a non-standard port, you may specify this e.g    as
  495.            foo.bar:1234. If    you don't want knews to    autoconnect,
  496.            don't set this or $NNTPSERVER.
  497.  
  498.       KKKKnnnneeeewwwwssss....eeeeddddiiiittttCCCCoooommmmmmmmaaaannnndddd
  499.            This resource specifies the editor used to edit posts.
  500.            Possible    values include:
  501.  
  502.            Knews.editCommand:  xemacs +%i %s
  503.            Knews.editCommand:  emacs +%i %s
  504.            Knews.editCommand:  xterm -e vi +%i %s
  505.  
  506.            %s stands for the name of a temporary file, and %i for
  507.            the line    where editing should begin. The    default    value
  508.            of this resource    is a compile time option.
  509.  
  510.       KKKKnnnneeeewwwwssss....uuuurrrrllllCCCCoooommmmmmmmaaaannnndddd
  511.            This command is used for    clicking on URLs.  %s is
  512.            expanded    to the URL, and    the result is passed to    the
  513.            shell.  As a simple security measure, URLs will not be
  514.            allowed to contain quotes, parentheses, whitespace or
  515.            ampersands.
  516.  
  517.       KKKKnnnneeeewwwwssss....pppprrrriiiinnnnttttCCCCoooommmmmmmmaaaannnndddd
  518.            If this resource    is set,    the misc menu will have    a
  519.            print option which invokes this command.
  520.  
  521.       KKKKnnnneeeewwwwssss....nnnneeeeeeeeddddssssTTTTeeeerrrrmmmmiiiinnnnaaaallll
  522.  
  523.  
  524.  
  525.      Page 8                         (printed 8/26/99)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  533.  
  534.  
  535.  
  536.       KKKKnnnneeeewwwwssss....ccccooooppppiiiioooouuuussssOOOOuuuuttttppppuuuutttt
  537.            These are two shell command templates that will be used
  538.            for mailcap viewers that    have the nnnneeeeeeeeddddsssstttteeeerrrrmmmmiiiinnnnaaaallll or the
  539.            ccccooooppppiiiioooouuuussssoooouuuuttttppppuuuutttt flag set, respectively.  In these,    %C
  540.            will be expanded    to the relevant    mailcap    command.  An
  541.            example should explain it:
  542.  
  543.            Knews.needsTerminal:    exec xterm -e /bin/sh -c '%C'
  544.            Knews.copiousOuptut:    exec xterm -e /bin/sh '(%C) | less'
  545.  
  546.       KKKKnnnneeeewwwwssss....mmmmiiiimmmmeeeeTTTTyyyyppppeeeessss
  547.            This should point to a file whose contents maps
  548.            filename    extensions to mime types.  The syntax of this
  549.            file is examplified by the following list of compiled
  550.            in types:
  551.  
  552.            image/jpeg           jpg jpeg
  553.            image/gif           gif
  554.            application/postscript  ps
  555.  
  556.            This is used to guess the Content-Type of attachments.
  557.  
  558.       KKKKnnnneeeewwwwssss....bbbbeeeellllllll
  559.            Setting this resource to    False will turn    off the    bell.
  560.  
  561.       KKKKnnnneeeewwwwssss....ssssoooorrrrttttGGGGrrrroooouuuuppppssss
  562.            If this is set to True, knews will keep newsgroups
  563.            alphabetically sorted when new groups are subscribed.
  564.  
  565.       KKKKnnnneeeewwwwssss....sssseeeeppppaaaarrrraaaatttteeeeWWWWiiiinnnnddddoooowwwwssss
  566.            Setting this resource to    True will make knews use a
  567.            different top level window for the article text widget.
  568.  
  569.       KKKKnnnneeeewwwwssss....ssssttttddddeeeerrrrrrrrTTTTiiiimmmmeeeeoooouuuutttt
  570.            When knews starts a pipe    or similar, it captures    the
  571.            standard    error output and displays it in    a notice
  572.            popup.  This resource is    the time in milliseconds this
  573.            popup should stay up.  The default is 10000.  Setting
  574.            this to 0 means stay up indefinitely, and negative
  575.            means no    popups.
  576.  
  577.       KKKKnnnneeeewwwwssss....sssshhhhoooowwwwCCCCaaaacccchhhheeee
  578.            If this is True,    knews will show    the state of the
  579.            article caches in a small popup.     See the config
  580.            options cacheAheadSize and cacheTrailSize for details.
  581.  
  582.       KKKKnnnneeeewwwwssss....mmmmaaaaiiiillllNNNNaaaammmmeeee
  583.            If you have a mail address which    isn't of the form
  584.            'userid@domain.name', you can set this to the part of
  585.            the address that    goes before the    '@', e.g.
  586.  
  587.            Knews.mailName:        FirstName.LastName
  588.  
  589.  
  590.  
  591.      Page 9                         (printed 8/26/99)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  599.  
  600.  
  601.  
  602.            Note that your userid will still    be used    for the
  603.            'Sender'    header if necessary.
  604.  
  605.       KKKKnnnneeeewwwwssss....uuuusssseeeeIIIIccccoooonnnn
  606.            If this is set to True (the default), knews will    use an
  607.            icon.
  608.  
  609.       KKKKnnnneeeewwwwssss....ccccoooonnnnffffiiiirrrrmmmmQQQQuuuuiiiitttt
  610.            Setting this to True will make knews ask    for
  611.            confirmation before disconnecting or quitting.
  612.  
  613.       KKKKnnnneeeewwwwssss....ccccoooonnnnffffiiiirrrrmmmmCCCCaaaattttcccchhhhuuuupppp
  614.            If this is set to True, knews will ask for confirmation
  615.            before catching up a group.
  616.  
  617.       KKKKnnnneeeewwwwssss....ccccoooonnnnffffiiiirrrrmmmmQQQQuuuuiiiittttGGGGrrrroooouuuupppp
  618.            If this is set to 'True', knews will ask    for
  619.            confirmation before leaving a group.  If    set to
  620.            'tagged', knews will ask    confirmation when exiting a
  621.            group if    there are tagged articles.
  622.  
  623.       KKKKnnnneeeewwwwssss....vvvviiiissssuuuuaaaallllCCCCllllaaaassssssss   ccccllllaaaassssssss
  624.       KKKKnnnneeeewwwwssss....vvvviiiissssuuuuaaaallllDDDDeeeepppptttthhhh   bbbbiiiittttssss
  625.            If these    are set    knews will use a visual    of the
  626.            specified class and depth.  Typical values for depth
  627.            are 8 or    24.  Legal values for class are    'StaticGray)',
  628.            'GrayScale', 'StaticColor', 'PseudoColor', 'TrueColor'
  629.            and 'DirectColor'.  The depth will be ignored if    no
  630.            class is    specified.
  631.  
  632.       KKKKnnnneeeewwwwssss....iiiinnnnssssttttaaaallllllllCCCCmmmmaaaapppp
  633.            If this is set to True, knews will create its own
  634.            colormap.
  635.  
  636.       KKKKnnnneeeewwwwssss....iiiinnnnlllliiiinnnneeeeIIIImmmmaaaaggggeeeessss
  637.            This boolean resource turns on/off inline images    and
  638.            color allocation.  Knews    can show jpeg, gif and png
  639.            images (if compiled with    support    for this).
  640.  
  641.       KKKKnnnneeeewwwwssss....nnnnCCCCoooollllssss
  642.            This is the maximum number of colors knews will
  643.            allocate    for inline images.  The    default    is 137 (17
  644.            greys and a 5x5x5 color cube minus the 5    greys in that
  645.            cube).
  646.  
  647.       KKKKnnnneeeewwwwssss....ccccoooolllloooorrrrHHHHaaaacccckkkk
  648.            If this is set to True, knews try to allocate the same
  649.            colors as other programs    have already allocated,    thus
  650.            increasing the chances for color    sharing.  The number
  651.            of colors is controlled by the resource Knews.nCols.
  652.  
  653.  
  654.  
  655.  
  656.  
  657.      Page 10                         (printed 8/26/99)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  665.  
  666.  
  667.  
  668.       The following    resources can be used to change    various    color,
  669.       font and geometry settings:
  670.  
  671.       KKKKnnnneeeewwwwssss****ggggrrrroooouuuupppplllliiiisssstttt....pppprrrreeeeffffeeeerrrrrrrreeeeddddLLLLiiiinnnneeeessss
  672.       KKKKnnnneeeewwwwssss****ggggrrrroooouuuupppplllliiiisssstttt....pppprrrreeeeffffeeeerrrrrrrreeeeddddCCCCoooolllluuuummmmnnnnssss
  673.            These resources specify the number of lines and columns
  674.            the grouplist widget will start up with.    The default is
  675.            14 for lines and    84 for columns.
  676.  
  677.       KKKKnnnneeeewwwwssss****tttteeeexxxxtttt....pppprrrreeeeffffeeeerrrrrrrreeeeddddLLLLiiiinnnneeeessss
  678.       KKKKnnnneeeewwwwssss****tttteeeexxxxtttt....pppprrrreeeeffffeeeerrrrrrrreeeeddddCCCCoooolllluuuummmmnnnnssss
  679.            These resources specify the number of lines and columns
  680.            the article text    widget start up    with. The default is
  681.            32 for lines and    84 for columns.
  682.  
  683.       KKKKnnnneeeewwwwssss****AAAArrrrttttTTTTrrrreeeeeeee....nnnnooooddddeeeeCCCCoooolllluuuummmmnnnnssss
  684.            The width of the    nodes in the article tree in
  685.            characters.  The    default    is 16.
  686.  
  687.       KKKKnnnneeeewwwwssss****rrrruuuubbbbbbbbeeeerrrrCCCCoooolllloooorrrr
  688.            The color used for rubberbanding    in one or two widgets.
  689.            The default is red.
  690.  
  691.       KKKKnnnneeeewwwwssss....hhhheeeeaaaaddddeeeerrrrCCCCoooolllloooorrrr
  692.       KKKKnnnneeeewwwwssss....bbbbooooddddyyyyCCCCoooolllloooorrrr
  693.       KKKKnnnneeeewwwwssss....qqqquuuuooootttteeeeCCCCoooolllloooorrrr
  694.            The colors used for headers, ordinary text and quoted
  695.            text respectiely    in the article window.
  696.  
  697.       KKKKnnnneeeewwwwssss****iiiinnnnnnnneeeerrrrCCCCoooolllloooorrrr
  698.       KKKKnnnneeeewwwwssss****iiiinnnnnnnneeeerrrrDDDDaaaasssshhhheeeedddd
  699.            The color and line style    used for the border of unread
  700.            articles    in the article tree. The defaults are Red and
  701.            False.
  702.  
  703.       KKKKnnnneeeewwwwssss****oooouuuutttteeeerrrrCCCCoooolllloooorrrr
  704.       KKKKnnnneeeewwwwssss****oooouuuutttteeeerrrrDDDDaaaasssshhhheeeedddd
  705.            The color and line style    used for the border of tagged
  706.            articles    in the article tree. The defaults are
  707.            foreground and False.
  708.  
  709.       KKKKnnnneeeewwwwssss****SSSSccccrrrrLLLLiiiisssstttt....ffffoooonnnntttt
  710.            The font    used in    the lists.
  711.  
  712.       KKKKnnnneeeewwwwssss....ddddeeeeffffaaaauuuullllttttHHHHoooottttCCCCoooolllloooorrrr
  713.            The color used for hot entries in the kill file when
  714.            the specified color is invalid or cannot    be allocated.
  715.  
  716.  
  717.       Some miscellaneous resources:
  718.  
  719.       KKKKnnnneeeewwwwssss....iiiiccccaaaasssseeeeRRRReeeeggggeeeexxxxppppssss
  720.  
  721.  
  722.  
  723.      Page 11                         (printed 8/26/99)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  731.  
  732.  
  733.  
  734.            Setting this to False will make regular expressions
  735.            case sensitive.    They are case insensitive by default.
  736.  
  737.       KKKKnnnneeeewwwwssss....rrrreeeeaaaaddddAAAAccccttttiiiivvvveeeeFFFFiiiilllleeee
  738.       KKKKnnnneeeewwwwssss....rrrreeeettttrrrriiiieeeevvvveeeeDDDDeeeessssccccrrrriiiippppttttiiiioooonnnnssss
  739.       KKKKnnnneeeewwwwssss....ffffiiiillllllllNNNNeeeewwwwssssrrrrccccFFFFiiiilllleeee
  740.       KKKKnnnneeeewwwwssss....sssshhhhoooowwwwNNNNuuuummmmbbbbeeeerrrrLLLLiiiinnnneeeessss
  741.       KKKKnnnneeeewwwwssss....kkkkeeeeeeeeppppTTTThhhhrrrreeeeaaaaddddIIIInnnnffffoooo
  742.       KKKKnnnneeeewwwwssss....cccchhhheeeecccckkkkFFFFoooorrrrNNNNeeeewwwwGGGGrrrroooouuuuppppssss
  743.            These set the default values for    the corresponding
  744.            configuration options.  Their main purpose is to    allow
  745.            command line arguments.    Read the section on the    config
  746.            file for    details.
  747.  
  748.       KKKKnnnneeeewwwwssss....nnnneeeewwwwssssrrrrccccTTTTeeeemmmmppppllllaaaatttteeee
  749.       KKKKnnnneeeewwwwssss....oooollllddddNNNNeeeewwwwssssrrrrccccTTTTeeeemmmmppppllllaaaatttteeee
  750.            These set the default values for    the configuration
  751.            options newsrcFile and oldNewsrcFile, the default
  752.            values are ~/.newsrc-%s and ~/.oldnewsrc-%s.  A value
  753.            not containing %s will not be accepted; if you want the
  754.            traditional ~/.newsrc for a particular server, see the
  755.            resource    Knews.configNntpServer below.
  756.  
  757.       KKKKnnnneeeewwwwssss....kkkkiiiillllllllFFFFiiiilllleeeeTTTTeeeemmmmppppllllaaaatttteeee
  758.            This sets the default value of the config option
  759.            killFile.  The default value is ~/.knews/.kill-%s.
  760.  
  761.       KKKKnnnneeeewwwwssss....ggggrrrroooouuuuppppKKKKiiiillllllllFFFFiiiilllleeeeTTTTeeeemmmmppppllllaaaatttteeee
  762.            This is the template for    the per-group kill file.  The
  763.            default is ~/.knews/%s/%g/KILL, so that e.g. the
  764.            newsgroup news.software.readers will have
  765.            ~/.knews/%s/news/software/readers/KILL as kill file,
  766.            where %s    is the name of the server, as usual.
  767.  
  768.       KKKKnnnneeeewwwwssss....ccccoooonnnnffffiiiiggggFFFFiiiilllleeee
  769.            The configuration file used by knews.  The default
  770.            value is    ~/.knews/config-%s, a value not    containing %s
  771.            will not    be accepted.
  772.  
  773.       KKKKnnnneeeewwwwssss....ccccoooonnnnffffiiiiggggNNNNnnnnttttppppSSSSeeeerrrrvvvveeeerrrr
  774.       KKKKnnnneeeewwwwssss....ccccoooonnnnffffiiiiggggPPPPoooossssttttiiiinnnnggggAAAAggggeeeennnntttt
  775.            Setting configNntpServer    will make knews    Do The Right
  776.            Thing when the user first connects to this server,
  777.            which means setting the newsrc file for this server to
  778.            ~/.newsrc when creating the config file.
  779.  
  780.            If the configPostingAgent is set    this will be used for
  781.            the postingAgent    config option for the
  782.            configNntpServer.
  783.  
  784.       KKKKnnnneeeewwwwssss....ggggeeeennnneeeerrrraaaatttteeeePPPPaaaatttthhhh
  785.            If this is set to True, knews will generate a Path
  786.  
  787.  
  788.  
  789.      Page 12                         (printed 8/26/99)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  797.  
  798.  
  799.  
  800.            header for articles.  The header    will be    'Path: d!u'
  801.            where d and u are such that the From header generated
  802.            by knews    would be 'From:    u@d'.
  803.  
  804.       KKKKnnnneeeewwwwssss....aaaauuuuttttooooSSSSuuuubbbbssssccccrrrriiiibbbbeeee
  805.            The value of this resource will be used when creating a
  806.            new newsrc file.     If it starts with a '/', it is    taken
  807.            as a pathname of    a file whose contents will be inserted
  808.            into the    new newsrc file, otherwise the literal value
  809.            of this resource    will be    inserted into the newsrc file.
  810.            The default value is
  811.  
  812.           news.answers:\nnews.newusers.questions:\n
  813.  
  814.       KKKKnnnneeeewwwwssss....bbbboooogggguuuussssFFFFiiiilllleeeeSSSSyyyysssstttteeeemmmm
  815.            When knews checks for new groups, it uses the atime
  816.            (time of    last access) of    the config file.  Some
  817.            filesystems (e.g. AFS) have no concept of atime,    but
  818.            fakes it    with mtime (time of last modification)
  819.            instead.     Setting this resource to True will make knews
  820.            forcibly    update the mtime of the    config file.
  821.  
  822.  
  823.  
  824.      TTTTHHHHEEEE CCCCOOOONNNNFFFFIIIIGGGG    FFFFIIIILLLLEEEE
  825.       When knews connects to an NNTP server    it reads a
  826.       configuration    file that will affect its behavior.  This file
  827.       is by    default    called ~/.knews/config-%s where    %s expands to
  828.       the name of the server, but this may be changed with the
  829.       Knews.configFile resource.
  830.  
  831.       The syntax of    the config file    is the same as for X resource
  832.       files.  When knews can't find    the configure file, a new one
  833.       will be created containing some default settings and a few
  834.       examples settings that should    be sufficient to clue you in
  835.       as to    how it works.
  836.  
  837.       It is    possible to used #include statements in    the config
  838.       file to include other    files.    Relative pathnames are
  839.       considered relative to the current working directory,    which
  840.       for knews is always $HOME.  ~    pathnames are not handled in
  841.       #includes (if    you want that you have to hack Xlib).
  842.  
  843.       The following    global (i.e. per server) options exist.
  844.  
  845.       nnnneeeewwwwssssrrrrccccFFFFiiiilllleeee
  846.       oooollllddddNNNNeeeewwwwssssrrrrccccFFFFiiiilllleeee
  847.            These specify the newsrc    file and oldnewsrc file    for
  848.            this server.  ~ pathnames and the same %    expansions as
  849.            for saving are handled.    If oldnewsrc is    set to an
  850.            empty string, no    backup of the newsrc file will be
  851.            created.
  852.  
  853.  
  854.  
  855.      Page 13                         (printed 8/26/99)
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  863.  
  864.  
  865.  
  866.            The default values for these are    the values of the
  867.            resources Knews.newsrcTemplate and
  868.            Knews.oldNewsrcTemplate,    whose default values are
  869.            ~/.newsrc-%s and    ~/.oldnewsrc-%s, respectively.
  870.  
  871.            For a way of automatically using    the standard file
  872.            ~/.newsrc for a specific    server,    see the    resource
  873.            Knews.configNntpServer above.
  874.  
  875.       kkkkiiiillllllllFFFFiiiilllleeee
  876.            The kill    file. The default value    is the value of    the
  877.            resource    Knews.killFileTemplate,    whose default value is
  878.            ~/.kill-%s.
  879.  
  880.       ccccaaaacccchhhheeeeDDDDiiiirrrr
  881.            This directory is used for storing cached articles and
  882.            thread data for groups.    The default is
  883.            ~/.knews/cache-%s.
  884.  
  885.       rrrreeeeaaaaddddAAAAccccttttiiiivvvveeeeFFFFiiiilllleeee
  886.            Setting this to False will stop knews from reading the
  887.            active file when    connecting, using the groups in    the
  888.            newsrc file instead.  This will speed up    connection on
  889.            slow lines if you don't have too    many subscribed
  890.            groups.    The default is the value of the    resource
  891.            Knews.readActiveFile, whose default is True.
  892.  
  893.       rrrreeeettttrrrriiiieeeevvvveeeeDDDDeeeessssccccrrrriiiippppttttiiiioooonnnnssss
  894.            A boolean option    indicating whether to retrieve
  895.            newsgroup descriptions from the server. The default is
  896.            the value of the    resource Knews.retrieveDescriptions,
  897.            whose default is    True.  Setting this to False may
  898.            slightly    speed up connection time.
  899.  
  900.       ddddeeeessssccccrrrriiiippppttttiiiioooonnnnssssFFFFiiiilllleeee
  901.            If this is set, the given file will be used to cache
  902.            group descriptions: when    retrieveDescriptions is    True,
  903.            knews saves the descriptions to this file and when
  904.            retrieveDescriptions is False, knews reads descriptions
  905.            from this file instead of from the server.
  906.  
  907.       ffffiiiillllllllNNNNeeeewwwwssssrrrrccccFFFFiiiilllleeee
  908.            Setting this to True will make knews write all groups
  909.            it knows    about to the newsrc file, which    may be a good
  910.            idea if the option readActiveFile is set    to False.  The
  911.            default is the value of the resource
  912.            Knews.fillNewsrcFile, whose default is False, which
  913.            means only put information in the newsrc    file.
  914.  
  915.       ttttrrrryyyyLLLLiiiissssttttAAAAccccttttiiiivvvveeee
  916.            When this is True (the default) and readActiveFile is
  917.            False, knews will try the "LIST ACTIVE wildmat" nntp
  918.  
  919.  
  920.  
  921.      Page 14                         (printed 8/26/99)
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  929.  
  930.  
  931.  
  932.            extension.  If this fails knews will complain and fall
  933.            back to the old "GROUP" stuff.
  934.  
  935.       cccchhhheeeecccckkkkFFFFoooorrrrNNNNeeeewwwwGGGGrrrroooouuuuppppssss
  936.            This is a boolean option    indicating whether to check
  937.            for new groups when connecting to this server. The
  938.            default is True.     The atime (time of last access) of
  939.            the config file will be used for    the check.
  940.  
  941.       tttthhhhrrrreeeeaaaaddddAAAAhhhheeeeaaaaddddGGGGrrrroooouuuuppppssss
  942.            This is a white-space separated list of groups to be
  943.            automatically scheduled for thread ahead    when
  944.            connecting.  The    special    values 'all' and 'All' may be
  945.            used to designate all subscribed    groups with unread
  946.            articles    and all    subscribed groups, respectively.
  947.  
  948.       ssssaaaavvvveeeeTTTThhhhrrrreeeeaaaaddddIIIInnnnffffoooo
  949.            Setting this to True will allow 'thread ahead' data to
  950.            be saved    between    sessions: knews    will not remove    the
  951.            files with this data when quitting, and when connecting
  952.            knews will check    for these files    for all    subscribed
  953.            groups.    If this    is set,    the options threadAheadGroups
  954.            and keepThreadInfo will be ignored.
  955.  
  956.       rrrreeeessssccccaaaannnnTTTTiiiimmmmeeeeoooouuuutttt
  957.            This indicates the time in minutes between automatic
  958.            rescans.     The default is    60 minutes, 0 means no
  959.            automatic rescans.  Regardless of this, rescans will
  960.            only be performed at special points, to prevent a
  961.            'rescan-idle-rescan' loop.
  962.  
  963.       ggggrrrroooouuuuppppNNNNaaaammmmeeeeCCCCoooolllluuuummmmnnnnssss
  964.            The width of the    group name in the group    list, default
  965.            is 42.
  966.  
  967.       aaaasssskkkkHHHHoooowwwwMMMMaaaannnnyyyy
  968.            Setting this to True will make knews ask    at which
  969.            article the threading of    a group    should start.  A hack.
  970.  
  971.       ppppoooossssttttiiiinnnnggggAAAAggggeeeennnntttt
  972.            If this is specified, knews will    use this for posting,
  973.            instead of posting via NNTP.  If    your server requires
  974.            some kind of authentication that    only inews
  975.            understands, you    could set this to 'inews -h'.  Note
  976.            that inews appends the signature, so you    don't want
  977.            knews to    add one    too.
  978.  
  979.            Also see    the resource Knews.configPostingAgent above.
  980.  
  981.       aaaauuuutttthhhhIIIInnnnffffooooPPPPaaaassssssss
  982.       aaaauuuutttthhhhIIIInnnnffffooooUUUUsssseeeerrrr
  983.            These are used to implement the NNTP AUTHINFO USER/PASS
  984.  
  985.  
  986.  
  987.      Page 15                         (printed 8/26/99)
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  995.  
  996.  
  997.  
  998.            protocol    if required by the server.  These exist    mostly
  999.            for backward compatibility; authentication is usually
  1000.            only required when posting, and then it is better to
  1001.            use inews for postingAgent, since presumably inews
  1002.            knows all about the required authentication.
  1003.  
  1004.       Here is an example of    some settings that will    improve    things
  1005.       over a slow network connection:
  1006.  
  1007.       readActiveFile:       False
  1008.       retrieveDescriptions:       False
  1009.       descriptionsFile:       ~/.knews/cache-%s/descriptions
  1010.       fillNewsrcFile:       True
  1011.  
  1012.       but note that    you will probably want to read the active file
  1013.       and group descriptions at least the first time you connect
  1014.       to a server.
  1015.  
  1016.  
  1017.       The following    resources may be set on    a per group basis;
  1018.       they should be prefixed with the name    of the group they
  1019.       apply    to.
  1020.  
  1021.       kkkkeeeeeeeeppppTTTThhhhrrrreeeeaaaaddddIIIInnnnffffoooo
  1022.            This tells knews    whether    to keep    thread information in
  1023.            memory after the    group is exited.  This will make
  1024.            reentering the group fast. Legal    values are: True,
  1025.            Subscribed and False. 'Subscribed' means    only do    it if
  1026.            the group is subscribed,    and exists to allow settings
  1027.            such as:
  1028.  
  1029.            *keepThreadInfo:       Subscribed
  1030.  
  1031.            to keep thread info for all subscribed groups.  The
  1032.            default value for this option is    'Subscribed' if    the
  1033.            resource    Knews.keepThreadInfo is    set to True and
  1034.            'False' otherwise.
  1035.  
  1036.       ccccaaaacccchhhheeeeAAAAhhhheeeeaaaaddddSSSSiiiizzzzeeee
  1037.       ccccaaaacccchhhheeeeTTTTrrrraaaaiiiillllSSSSiiiizzzzeeee
  1038.            These two set the sizes of the two article caches, the
  1039.            defaults    are 0.    The 'ahead cache' is used to prefetch
  1040.            articles    from the server    in the background using    a
  1041.            second connection.  The 'trail cache' is    used to    keep
  1042.            articles    that you have already read, so that going
  1043.            back, saving or uudecoding will be faster.  The maximum
  1044.            values for these    are 32.
  1045.  
  1046.       ssssoooorrrrttttTTTThhhhrrrreeeeaaaaddddssss
  1047.            This indicates how the threads should be    sorted.     A
  1048.            thread consists of several subjects.  These are sorted
  1049.            within the thread according to the order    they occur.
  1050.  
  1051.  
  1052.  
  1053.      Page 16                         (printed 8/26/99)
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  1061.  
  1062.  
  1063.  
  1064.            Then the    threads    are sorted according to    the setting of
  1065.            this option.  The legal values and their    meanings are:
  1066.  
  1067.            subject         Alphabetically by the first subject in the    thread.
  1068.            size         Number of unread articles in the thread.
  1069.            full-size     Number of articles    in the thread.
  1070.            hot         Number of hot articles in the thread.
  1071.            date         The date of the first unread article.
  1072.            average-date  The average date of unread    articles in the    thread.
  1073.            author         Alphabetically by the first From: line in the thread.
  1074.            none         No    sorting.
  1075.  
  1076.            All these values    may be prefixed    with a minus sign to
  1077.            indicate    a reversal of the order, or a plus sign    which
  1078.            is a no-op.  The    default    value is none.
  1079.  
  1080.       eeeexxxxppppiiiirrrreeeeKKKKiiiillllllllssss
  1081.            Setting this to False will stop expirations from    the
  1082.            kill file.  The default is True,    which means that
  1083.            Message-id kills    will expire when you enter a group
  1084.            where the kill entry would have been applicable,    but
  1085.            the article with    that message-id    was not    found.
  1086.  
  1087.       aaaattttttttrrrriiiibbbbuuuuttttiiiioooonnnn
  1088.            This string is used to attribute    quotations when    you
  1089.            post a followup.    The default is
  1090.  
  1091.            In article %m,\n        %f writes:
  1092.  
  1093.            where \n    is a newline.  The following %'s are expanded:
  1094.  
  1095.            %%    %
  1096.            %d    The date of the quoted article in the form    01 Jan.
  1097.            %f    The From: line of the article replied to.
  1098.            %i    The initials of the previous poster.
  1099.            %I    The initials of the previous poster, capitalized.
  1100.            %m    The message-id of the article replied to.
  1101.            %n    The current newsgroup.
  1102.            %r    The real name of the previous poster.
  1103.            %s    The subject of the    quoted article.
  1104.            %t    The time of the quoted article in the form    18:24:02.
  1105.            %w    The week day of the quoted    article.
  1106.            %y    The year of the quoted article.
  1107.  
  1108.            Thus '%w, %d %y %t GMT' will give the date in standard
  1109.            rfc822 format.
  1110.  
  1111.       ffffuuuullllllllNNNNaaaammmmeeee
  1112.            This is the full    name used in the 'From:' header    in the
  1113.            articles    you post. The default is $NAME,    if set,
  1114.            otherwise the gecos field from the password file,
  1115.            suitably    truncated.
  1116.  
  1117.  
  1118.  
  1119.      Page 17                         (printed 8/26/99)
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  1127.  
  1128.  
  1129.  
  1130.       hhhheeeeaaaaddddeeeerrrrFFFFoooorrrrmmmmaaaatttt
  1131.            A colon and white-space separated list specifying which
  1132.            headers to show in the article window, and in what
  1133.            order. The default is
  1134.  
  1135.            Subject:Newsgroups:Followup-To:Reply-To:\
  1136.            Content-Description:Date:Organization:From:
  1137.  
  1138.            If the name of the header starts    with a captial letter
  1139.            (From: as opposed to from:), knews will decode rfc1522
  1140.            encoded words encountered in this header.  (Those are
  1141.            the weird things    that look like =?iso-8859-
  1142.            1?q?stuff_here?=.)  Encoded 16-bit charsets are not
  1143.            decoded in headers yet.
  1144.  
  1145.       aaaasssssssseeeemmmmbbbblllleeeePPPPaaaarrrrttttiiiiaaaallllssss
  1146.            This boolean tells whether message/partial articles
  1147.            will be remembered and offered for assembly.
  1148.  
  1149.       qqqquuuuooootttteeeeRRRReeeeggggeeeexxxxpppp
  1150.            Lines in    an article matching this regular expression
  1151.            will be considered quoted lines,    and may    be marked with
  1152.            a different color and font. The default is
  1153.  
  1154.            ^[ \t]*[:>|]
  1155.  
  1156.            which matches lines beginning with an arbitrary amount
  1157.            of white    space (the \t denotes a    tab, note that \t
  1158.            won't actually work) followed by    a >, : or | character.
  1159.  
  1160.            You will    probably want to have this expression
  1161.            anchored...
  1162.  
  1163.       ddddeeeeffffaaaauuuullllttttCCCChhhhaaaarrrrsssseeeetttt
  1164.            The fonts for this charset will be used to display
  1165.            articles    that lack MIME-headers.     If this is not    set,
  1166.            us-ascii    will be    assumed.
  1167.  
  1168.            Also, rfc1522 encodings of this charset in the From and
  1169.            Subject header will be decoded when displayed in    the
  1170.            article tree and    the thread list.  In this case,    iso-
  1171.            8859-1 is the default.
  1172.  
  1173.       sssshhhhoooowwwwNNNNuuuummmmbbbbeeeerrrrLLLLiiiinnnneeeessss
  1174.            A boolean option    indicating whether to show the number
  1175.            of lines    in articles in the thread tree.     The default
  1176.            is the value of the resource Knews.showNumberLines,
  1177.            whose default is    False.
  1178.  
  1179.       ssssiiiiggggnnnnaaaattttuuuurrrreeeeFFFFiiiilllleeee
  1180.            The contents of this file will be used to sign the
  1181.            articles    you post (before editing). The default is
  1182.  
  1183.  
  1184.  
  1185.      Page 18                         (printed 8/26/99)
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  1193.  
  1194.  
  1195.  
  1196.            ~/.signature.
  1197.  
  1198.       ssssuuuubbbbjjjjeeeeccccttttCCCCoooolllluuuummmmnnnnssss
  1199.            The width of the    subject    in the thread list, default is
  1200.            56.
  1201.  
  1202.       qqqquuuuooootttteeeeSSSSttttrrrriiiinnnngggg
  1203.       qqqquuuuooootttteeeeQQQQuuuuooootttteeeeSSSSttttrrrriiiinnnngggg
  1204.            These strings are used for quoting when posting a
  1205.            followup    article; the first one are used    to quote lines
  1206.            that were not quoted in the original article, and the
  1207.            second one is used for lines that were already quoted.
  1208.            What lines are considered quoted    is determined by the
  1209.            quoteRegexp.  The defaults are "> " and ">"
  1210.            respectively.  In these strings,    %i is expanded to the
  1211.            initials    of the previous    author and %I to the initials,
  1212.            capitalized.
  1213.  
  1214.       ppppoooosssstttteeeeddddAAAAnnnnddddMMMMaaaaiiiilllleeeedddd
  1215.            This string will    be instered into articles that are
  1216.            also mailed to the previous author.  The    default    is
  1217.            "[posted    and mailed]".
  1218.  
  1219.       ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn
  1220.            If this is set, it will be used as the content of a
  1221.            'Distribution' header.  The default value is the    value
  1222.            of the environment variable DEFNEWSDIS if set,
  1223.            otherwise empty.
  1224.  
  1225.       ffffuuuullllllllHHHHeeeeaaaaddddeeeerrrr
  1226.            A boolean specifying whether to show all    headers    in the
  1227.            article window. It also means turn off all MIME
  1228.            transformations.    The default is False.
  1229.  
  1230.       rrrreeeeppppllllyyyyTTTToooo
  1231.            A string    used to    construct the 'Reply-To:' header in
  1232.            the articles you    post. The default is the value of the
  1233.            environment variable REPLYTO if set, otherwise empty.
  1234.  
  1235.       oooorrrrggggaaaannnniiiizzzzaaaattttiiiioooonnnn
  1236.            A string    used to    construct the 'Organization:' header
  1237.            in the articles you post. The default is    $NEWSORG if
  1238.            set, otherwise $ORGANIZATION if set, otherwise nothing.
  1239.  
  1240.       pppprrrroooocccceeeessssssssXXXXrrrreeeeffffssss
  1241.            If this boolean is True,    as it is by default, articles
  1242.            that are    crossposted will be marked read    in all groups
  1243.            when you    read them, mark    them read, kill    them or    catch
  1244.            them up.
  1245.  
  1246.            Note that this only applies to subscribed groups, and
  1247.            will only work if the server's overview file contains
  1248.  
  1249.  
  1250.  
  1251.      Page 19                         (printed 8/26/99)
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  1259.  
  1260.  
  1261.  
  1262.            the Xref: headers.
  1263.  
  1264.       eeeexxxxttttrrrraaaaHHHHeeeeaaaaddddeeeerrrrssss
  1265.            This string is inserted into the    head of    all articles
  1266.            you post    (before    editing). The default is empty.     This
  1267.            could be    used to    put in Mime headers, like this:
  1268.  
  1269.            *extraHeaders:    Content-Type: text/plain; charset=iso-8859-1
  1270.  
  1271.       ffffoooolllllllloooowwwwuuuuppppHHHHeeeeaaaaddddeeeerrrrssss
  1272.            This is a combination of    extraHeaders and attribution:
  1273.            it is inserted in the headers of    replies    and followups
  1274.            and the same %'s    as in attribution are expanded.     An
  1275.            example:
  1276.  
  1277.            *followupHeaders:   X-Comment-To: %r
  1278.  
  1279.       uuuuuuuuDDDDiiiirrrr
  1280.            Uudecoded files will end    up in this directory.  Or
  1281.            rather, the forked off uudecoding process will be given
  1282.            this as its current working directory.  The default is
  1283.            ~/News.
  1284.  
  1285.       uuuuuuuuPPPPrrrrooooggggrrrraaaammmm
  1286.            This program will be used to uudecode files: it will be
  1287.            given the bodies    of the relevant    articles on standard
  1288.            input.  The default is NULL, which means    that knews
  1289.            will do its best    to filter out garbage and then pipe
  1290.            the rest    to 'uudecode'.
  1291.  
  1292.       Here is an example of    how to set different signatures    for
  1293.       different newsgroups:
  1294.  
  1295.       swnet*signatureFile:       ~/.signature-svensk
  1296.       de*signatureFile:       ~/.signature-deutsch
  1297.       *linux*signatureFile:       ~/.signature-linux
  1298.  
  1299.       The first sets the file ~/.signature-svensk for all groups
  1300.       in the swnet hierarchy, the second one sets the file
  1301.       ~/.signature-deutsch for the de hierarchy, and the last one
  1302.       sets the file    ~/.signature-linux for any group containing
  1303.       linux    as a component (not merely a substring).  The file
  1304.       ~/.signature will be used for    all other groups.
  1305.  
  1306.  
  1307.  
  1308.      AAAACCCCTTTTIIIIOOOONNNNSSSS
  1309.       Knews    defines    a number of actions that can be    tied to    keys
  1310.       and buttons via translations.     For the default translations,
  1311.       see the application defaults file.
  1312.  
  1313.       ddddoooo----tttthhhheeee----rrrriiiigggghhhhtttt----tttthhhhiiiinnnngggg(((())))
  1314.  
  1315.  
  1316.  
  1317.      Page 20                         (printed 8/26/99)
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  1325.  
  1326.  
  1327.  
  1328.            Does the    right thing.
  1329.  
  1330.       kkkkiiiillllllll----aaaappppppppeeeennnndddd((((ffffiiiieeeelllldddd,,,, ssssccccooooppppeeee [[[[,,,, ccccoooolllloooorrrr]]]]))))
  1331.       kkkkiiiillllllll----pppprrrreeeeppppeeeennnndddd((((ffffiiiieeeelllldddd,,,, ssssccccooooppppeeee [[[[,,,, ccccoooolllloooorrrr]]]]))))
  1332.            These action procedures append and prepend respectively
  1333.            entries to the kill file    for the    current    group
  1334.            according to the    currently selected article.
  1335.  
  1336.            Valid values for    the 'field' parameter are "From",
  1337.            "Subject" and "Message-Id", and valid values for
  1338.            'scope' are "Thread", "Subthread" and "Subject".     If
  1339.            the color parameter is present, the entry added is a
  1340.            hot-entry with that color, otherwise it is a kill-
  1341.            entry.
  1342.  
  1343.            It is probably a    good idea to use these with field =
  1344.            "message-id", since message-id kills are    very efficient
  1345.            and expire with the corresponding article.
  1346.  
  1347.       ppppooooppppuuuupppp----kkkkiiiillllllll(((([[[[ggggrrrroooouuuupppp]]]]))))
  1348.            This will popup a kill file editor for the supplied
  1349.            group.  If no group is given, the editor    for the    global
  1350.            kill file is popped up.
  1351.  
  1352.       mmmmiiiimmmmeeee----hhhhaaaacccckkkk((((ccccoooonnnntttteeeennnntttt----ttttyyyyppppeeee,,,, ccccoooonnnntttteeeennnntttt----ttttrrrraaaannnnssssffffeeeerrrr----eeeennnnccccooooddddiiiinnnngggg))))
  1353.            This action procedure reloads the current article,
  1354.            pretending it had the specified Content-Type and
  1355.            Content-Transfer-Encoding headers.  For example mime-
  1356.            hack(image/jpeg,    uue) reloads the current article
  1357.            pretending it has Content-Type image/jpeg and is
  1358.            uuencoded, thus makeing knews display it    as an inline
  1359.            image.
  1360.  
  1361.            The default key-bindings    have the following:
  1362.            ctrl-J       mime-hack(image/jpeg, uue)
  1363.            ctrl-G       mime-hack(image/gif,    uue)
  1364.            ctrl-P       mime-hack(image/png,    uue)
  1365.  
  1366.       ttttrrrreeeeeeee----uuuupppp((((aaaarrrrgggg))))
  1367.       ttttrrrreeeeeeee----ddddoooowwwwnnnn((((aaaarrrrgggg))))
  1368.       ttttrrrreeeeeeee----lllleeeefffftttt((((aaaarrrrgggg))))
  1369.       ttttrrrreeeeeeee----rrrriiiigggghhhhtttt((((aaaarrrrgggg))))
  1370.       ttttrrrreeeeeeee----ddddoooowwwwnnnn----rrrriiiigggghhhhtttt((((aaaarrrrgggg))))
  1371.            These move around in the    thread tree. If    the arg    is
  1372.            'read', they will also read in the relevant article, if
  1373.            arg is 'fake', they will    also try to read 'fake'
  1374.            articles.
  1375.  
  1376.       lllliiiisssstttt----uuuupppp((((aaaarrrrgggg))))
  1377.       lllliiiisssstttt----ddddoooowwwwnnnn((((aaaarrrrgggg))))
  1378.            These move up and down in the lists. If arg is given,
  1379.            it is the number    of steps, or if    it contains a '.', the
  1380.  
  1381.  
  1382.  
  1383.      Page 21                         (printed 8/26/99)
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  1391.  
  1392.  
  1393.  
  1394.            fraction    of the window to move.
  1395.  
  1396.       eeeennnntttteeeerrrr----mmmmooooddddeeee(((())))
  1397.       eeeexxxxiiiitttt----mmmmooooddddeeee(((())))
  1398.            These two actions moves between modes.
  1399.  
  1400.       ttttrrrreeeeeeee----oooorrrr----lllliiiisssstttt----uuuupppp((((aaaarrrrgggg))))
  1401.       ttttrrrreeeeeeee----oooorrrr----lllliiiisssstttt----ddddoooowwwwnnnn((((aaaarrrrgggg))))
  1402.       ttttrrrreeeeeeee----lllleeeefffftttt----oooorrrr----eeeexxxxiiiitttt----mmmmooooddddeeee((((aaaarrrrgggg))))
  1403.       ttttrrrreeeeeeee----rrrriiiigggghhhhtttt----oooorrrr----eeeennnntttteeeerrrr----mmmmooooddddeeee((((aaaarrrrgggg))))
  1404.            These are combination actions.  E.g. tree-or-list-
  1405.            up(arg) does tree-up or list-up(1), depending on    which
  1406.            is relevant.
  1407.  
  1408.       rrrreeeeaaaadddd----aaaarrrrttttiiiicccclllleeee((((aaaarrrrgggg))))
  1409.            This rereads the    current    article. If arg    is given, the
  1410.            article is displayed with full header and no MIME
  1411.            transformations.
  1412.  
  1413.       vvvviiiieeeewwww----tttthhhhrrrreeeeaaaadddd((((aaaarrrrgggg))))
  1414.            This moves between the subject list and the thread
  1415.            tree. If    arg is 'toggle', it toggles, if    arg is 'yes'
  1416.            it goes to the tree, and    if arg is 'no',    it goes    to the
  1417.            subject list.
  1418.  
  1419.       ffffoooolllllllloooowwwwuuuupppp((((aaaarrrrgggg))))
  1420.       rrrreeeeppppllllyyyy((((aaaarrrrgggg))))
  1421.       ffffoooolllllllloooowwwwuuuupppp----aaaannnndddd----rrrreeeeppppllllyyyy((((aaaarrrrgggg))))
  1422.       ppppoooosssstttt----nnnneeeewwww(((())))
  1423.            These correspond    to the options on the post menu. If
  1424.            arg is given as 'yes' or    'no', it indicates whether to
  1425.            include quoted text.
  1426.  
  1427.       uuuuuuuuddddeeeeccccooooddddeeee(((())))
  1428.       cccclllleeeeaaaarrrr----ttttaaaaggggggggeeeedddd(((())))
  1429.       mmmmaaaarrrrkkkk----rrrreeeeaaaadddd----aaaarrrrttttiiiicccclllleeee(((())))
  1430.       mmmmaaaarrrrkkkk----rrrreeeeaaaadddd----ssssuuuubbbbjjjjeeeecccctttt(((())))
  1431.       mmmmaaaarrrrkkkk----rrrreeeeaaaadddd----tttthhhhrrrreeeeaaaadddd(((())))
  1432.       mmmmaaaarrrrkkkk----rrrreeeeaaaadddd----ssssuuuubbbbtttthhhhrrrreeeeaaaadddd(((())))
  1433.       mmmmaaaarrrrkkkk----rrrreeeeaaaadddd----ttttoooo----ccccuuuurrrrrrrreeeennnntttt(((())))
  1434.       mmmmaaaarrrrkkkk----rrrreeeeaaaadddd----aaaallllllll(((())))
  1435.       mmmmaaaarrrrkkkk----rrrreeeeaaaadddd----ttttaaaaggggggggeeeedddd(((())))
  1436.       mmmmaaaarrrrkkkk----rrrreeeeaaaadddd----nnnnoooonnnn----ttttaaaaggggggggeeeedddd(((())))
  1437.       mmmmaaaarrrrkkkk----rrrreeeeaaaadddd----ccccoooolllldddd(((())))
  1438.       mmmmaaaarrrrkkkk----uuuunnnnrrrreeeeaaaadddd----aaaarrrrttttiiiicccclllleeee(((())))
  1439.       mmmmaaaarrrrkkkk----uuuunnnnrrrreeeeaaaadddd----ssssuuuubbbbjjjjeeeecccctttt(((())))
  1440.       mmmmaaaarrrrkkkk----uuuunnnnrrrreeeeaaaadddd----tttthhhhrrrreeeeaaaadddd(((())))
  1441.       mmmmaaaarrrrkkkk----uuuunnnnrrrreeeeaaaadddd----ssssuuuubbbbtttthhhhrrrreeeeaaaadddd(((())))
  1442.       mmmmaaaarrrrkkkk----uuuunnnnrrrreeeeaaaadddd----aaaallllllll(((())))
  1443.       mmmmaaaarrrrkkkk----uuuunnnnrrrreeeeaaaadddd----ttttaaaaggggggggeeeedddd(((())))
  1444.       mmmmaaaarrrrkkkk----uuuunnnnrrrreeeeaaaadddd----kkkkiiiilllllllleeeedddd(((())))
  1445.            These perform the corresponding functions on the    misc
  1446.  
  1447.  
  1448.  
  1449.      Page 22                         (printed 8/26/99)
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  1457.  
  1458.  
  1459.  
  1460.            menu.
  1461.  
  1462.       ppppiiiippppeeee((((ccccoooommmmmmmmaaaannnndddd,,,,    ppppaaaarrrrttttssss [[[[,,,, ssssccccooooppppeeee]]]]))))
  1463.       ssssaaaavvvveeee((((ffffiiiilllleeeennnnaaaammmmeeee,,,, ppppaaaarrrrttttssss [[[[,,,, ssssccccooooppppeeee]]]]))))
  1464.            Pipe and    save actions.  The argument 'parts' is a
  1465.            combination of the characters 'f', 's', 'h', 'b', 'e',
  1466.            corresponding to    the 'bogus from', 'bogus subject',
  1467.            'head', 'body' and 'empty line' options on the save
  1468.            popup window.  The 'scope' parameter is optional, and
  1469.            is one of 'window', 'article', 'subject', 'thread',
  1470.            'subthread' and 'tagged', corresponding to those
  1471.            options on the save popup.
  1472.  
  1473.       ttttaaaagggg----tttthhhhrrrreeeeaaaadddd(((([[[[aaaallllllll]]]]))))
  1474.       ttttaaaagggg----ssssuuuubbbbjjjjeeeecccctttt(((([[[[aaaallllllll]]]]))))
  1475.            These tag the unread articles in    a thread or subject.
  1476.            If 'all'    is specified, they tag all articles in the
  1477.            thread or subject.
  1478.  
  1479.       uuuunnnnttttaaaagggg----tttthhhhrrrreeeeaaaadddd(((())))
  1480.       uuuunnnnttttaaaagggg----ssssuuuubbbbjjjjeeeecccctttt(((())))
  1481.            These untag the tagged articles in a thread or subject.
  1482.  
  1483.       ttttaaaagggg----hhhhooootttt(((())))
  1484.            This action tags    all unread hot articles, same as on
  1485.            the misc    menu.
  1486.  
  1487.       ccccaaaattttcccchhhhuuuupppp(((())))
  1488.       uuuunnnnssssuuuubbbbssssccccrrrriiiibbbbeeee(((())))
  1489.       ssssuuuubbbbssssccccrrrriiiibbbbeeee(((())))
  1490.            Guess what.
  1491.  
  1492.       cccchhhhaaaannnnggggeeee----ssssiiiizzzzeeee((((ppppiiiixxxxeeeellllssss))))
  1493.            Changes the size    of the upper portion of    the main
  1494.            window by the specified number of pixels.
  1495.  
  1496.       sssscccchhhheeeedddduuuulllleeee----tttthhhhrrrreeeeaaaadddd----aaaahhhheeeeaaaadddd(((())))
  1497.            Causes a    group to be scheduled for 'thread ahead'.
  1498.  
  1499.       ppppooooppppuuuupppp----ffffiiiinnnndddd----ggggrrrroooouuuupppp(((())))
  1500.            Popups the 'find    group' popup, same as the 'find    group'
  1501.            option on the misc menu.
  1502.  
  1503.  
  1504.      WWWWIIIIDDDDGGGGEEEETTTTSSSS
  1505.       The X    interface of knews is built with its own widget    set
  1506.       plus the Layout Widget. You are welcome to use it if you
  1507.       like.    Unfortunately there is no documentation.
  1508.  
  1509.  
  1510.      AAAAUUUUTTTTHHHHOOOORRRR
  1511.       This software    is Copyright 1995, 1996    by Karl-Johan
  1512.  
  1513.  
  1514.  
  1515.      Page 23                         (printed 8/26/99)
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.      KKKKNNNNEEEEWWWWSSSS((((1111))))           UUUUNNNNIIIIXXXX    SSSSyyyysssstttteeeemmmm VVVV ((((1111999999996666))))              KKKKNNNNEEEEWWWWSSSS((((1111))))
  1523.  
  1524.  
  1525.  
  1526.       Johnsson.
  1527.  
  1528.  
  1529.      AAAACCCCKKKKNNNNOOOOWWWWLLLLEEEEDDDDGGGGMMMMEEEENNNNTTTTSSSS
  1530.       The threading    algorithm was inspired from trn. Thanks    to
  1531.       Wayne    Davison.
  1532.  
  1533.       Knews    uses Keith Packard's Layout Widget.
  1534.  
  1535.       The distribution includes Henry Spencer's regex package for
  1536.       environments that do not have    the POSIX.2 regular expression
  1537.       functions.
  1538.  
  1539.       Thanks to Mattias Jonsson for    ardent testing.
  1540.  
  1541.       From the gif89a spec:
  1542.  
  1543.       "The Graphics    Interchange Format(c) is the Copyright property    of
  1544.        CompuServe Incorporated. GIF(sm) is a Service Mark property of
  1545.        CompuServe Incorporated."
  1546.  
  1547.  
  1548.       Any problems are of course entirely due to me.
  1549.  
  1550.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  1551.       egrep(1), knewsd(1), trn(1), uudecode(1), mailcap(5),
  1552.       newsrc(5), regex(7).
  1553.  
  1554.  
  1555.      KKKKNNNNOOOOWWWWNNNN PPPPRRRROOOOBBBBLLLLEEEEMMMMSSSS
  1556.       If the server    doesn't    support    XOVER, threading will be very
  1557.       slow.
  1558.  
  1559.       The uudecode function    may not    recognize or correctly handle
  1560.       all cases.
  1561.  
  1562.       The dithering    algorithm used for grayscale images and    color
  1563.       gifs (essentially 'closest match') is    very poor.
  1564.  
  1565.       AUTHINFO SIMPLE doesn't work for the second connection.
  1566.  
  1567.       When the last    article    in a group has been cancelled, the
  1568.       number of unread articles may    be incorrect.
  1569.  
  1570.  
  1571.      BBBBUUUUGGGGSSSS
  1572.       Send bug reports to kjj@matematik.su.se
  1573.  
  1574.  
  1575.      SSSSGGGGIIII FFFFRRRREEEEEEEEWWWWAAAARRRREEEE
  1576.       Configured and built for SGI Freeware    by Vince Levey
  1577.       (hhhhttttttttpppp::::////////rrrreeeeaaaalllliiiittttyyyy....ssssggggiiii....ccccoooommmm////vvvviiiinnnncccceeeellll////).
  1578.  
  1579.  
  1580.  
  1581.      Page 24                         (printed 8/26/99)
  1582.  
  1583.  
  1584.  
  1585.